Installing and Starting FMS Toolbox

Use the CygNet Client Installer (CygNet\Clients\CInstall.exe) to install the CygNet FMS Toolbox application. The CygNet Client Installer sets up integrated version management to ensure that you have the latest version of the application files. See CygNet Client Installer for more information.

Installing FMS Toolbox

To Install and Start CygNet FMS Toolbox Using the CygNet Client Installer

1. Open the CygNet Client Installer (Start Menu > All Programs > CygNet > CygNet Client Installer). The CygNet Client Installer/Launcher dialog box will be displayed.

2. On the Blob Service: Admin drop-down menu, select your APPS Site.Service.
3. In the Blob Folder: list, select UTILS to access the list of utilities available for installation.
4. In the Select CygNet Applications to Install list, select FMS Toolbox.
5. Click the check box adjacent to Add shortcut to desktop to select/clear this feature. Selecting this feature ensures that you have version management settings.
6. Click Install. A confirmation message will be displayed asking if you want to start the application.
7. Select Yes to start FMS Toolbox.

   When the application is started, the CygNet FMS Toolbox dialog box will appear.

Starting FMS Toolbox

After installation, there are several ways to start FMS Toolbox. Some methods provide version management and some do not.

Methods Providing Version Management

Once FMS Toolbox has been installed using the CygNet Client Installer, you can open the application using either of the following methods. Both of these methods provide version management for the FMS Toolbox application.

• Start the application using the CygNet Client Installer.

  Follow the installation procedure above to step 6 and then click Launch.

• Start the application using the Start menu shortcut.

  From the Start menu, browse to Programs > CygNet > CygNet FMS Toolbox and click the application icon .

Methods Not Providing Version Management

Alternatively, you can open the application using either of the following methods. These methods do not provide version management.

• Start the application using Windows Explorer.

  Browse to the CygNet\Utilities directory and double-click the FMS Toolbox executable (FmsToolbox.exe).

• Start the application from a command line.

  In the command window, specify the location of the FMS Toolbox application, C:\CygNet\Utilities\FmsToolbox.exe in the following example. See Running a Command-Line Utility for more information.

  Note: You can use this method to automate GMR Migration operations (Events, Contract Hour, and History) using a third-party scheduler such as the Microsoft Windows Task Scheduler.

Command-line Parameters

Available command-line parameter options for use in FMS Toolbox can be viewed by typing /Help into the command window following the application location. Options are described in the following table.

Example

Enter the location of the FMS Toolbox application and optionally include the XML parameter and file path, and/or the auto-close parameter, as follows.

XML Configuration File

Example

The .xml file specified contains the values for the required GMR Migration fields as follows.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?xml version="1.0"?>
<ToolboxConfig>
    <Operation opType="MigrateEvents">
        <GmrSvc>SAMPLE1.GMR</GmrSvc>
        <FmsSvc>SAMPLE1.FMS</FmsSvc>
        <AuditCategory>SampleAudit</AuditCategory>
        <AuditComment>SampleComment</AuditComment>
        <LoadFromResults>false</LoadFromResults>
        <StartDate>T-7</StartDate>
        <EndDate>T</EndDate>
        <Groups>
            <GroupName>SampleGroup</GroupName>
        </Groups>
        <ResultsFile>Sample.csv</ResultsFile>
        <VerboseMessage>true</VerboseMessage>
    </Operation>
    <Operation opType="MigrateHistory">
        <GmrSvc>SAMPLE1.GMR</GmrSvc>
        <FmsSvc>SAMPLE1.FMS</FmsSvc>
        <AuditCategory>SampleAudit</AuditCategory>
        <AuditComment>SampleComment</AuditComment>
        <LoadFromResults>false</LoadFromResults>
        <StartDate>2/14/2022</StartDate>
        <EndDate>3/17/2024</EndDate>
        <Groups>
            <GroupName>SampleGroup</GroupName>
        </Groups>
        <ResultsFile>Sample.csv</ResultsFile>
        <VerboseMessage>true</VerboseMessage>
    </Operation>
</ToolboxConfig>

You can also run GMR migration operations across domains and/or between computers for which you have security access.

Accessing Different Domains or Computers

Examples

Specify different CygNet domains by enclosing the domain in square brackets (e.g. [5432]) preceding the Site.Service (e.g. Sample1.FMS).

Specify different computers (in the same or different domains) using each Site.Service name.